Social sentiment
Description
Bull / bear / neutral ratios and AI summaries (English snippets) for a token.
Use cases
- Crowd positioning vs price
- Pair with real-time capital endpoints for fuller picture
Tips
- NL “market sentiment” → this API and real-time flow API
Update: Every 30 minutes
Endpoint
- Method:
POST - Path:
/open/v1/social-sentiment/getCoinSocialSentiment
Credits
- Cost:
3
Prerequisites
vsTokenId
Request body (JSON)
| Field | Type | Required | Description |
|---|---|---|---|
| vsTokenId | long | Yes | Token id |
Response — data
| Field | Type | Serialized | Description |
|---|---|---|---|
| updateTime | long | long | Data time (ms) |
| vsTokenId | long | string | Token id |
| symbol | string | string | Ticker |
| name | string | string | Name |
| bullishRatio | number | number | Bull share 0–1 |
| neutralRatio | number | number | Neutral 0–1 |
| bearishRatio | number | number | Bear 0–1 |
| bearishContents | array | array | Bearish blurbs |
| english | string | string | English text |
| updateTime | long | long | Blurb time |
| neutralContents | array | array | Neutral blurbs |
| bullishContents | array | array | Bullish blurbs |
Semantics
| Field | Meaning | Tip |
|---|---|---|
| bullishRatio | Crowd risk-on | →1 very bullish |
| neutralRatio | Wait-and-see | |
| bearishRatio | Risk-off | →1 very bearish |
| *Contents | AI bullets | Explain why |
Example
json
{
"vsTokenId": 1
}cURL (Linux/macOS)
bash
curl --location --request POST 'http://${host}/api/open/v1/social-sentiment/getCoinSocialSentiment' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
"vsTokenId": 1
}'cURL (Windows CMD)
cmd
curl --location --request POST "http://${host}/api/open/v1/social-sentiment/getCoinSocialSentiment" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{ \"vsTokenId\": 1}"Sample success
json
{
"code": 200,
"message": "success",
"data": {
"updateTime": 1773315931000,
"vsTokenId": "1",
"symbol": "BTC",
"name": "Bitcoin",
"bullishRatio": 0.4113,
"neutralRatio": 0.4937,
"bearishRatio": 0.095,
"bearishContents": [
{
"english": "$BTC faces conflicting narratives...",
"updateTime": 1773316047000
}
],
"neutralContents": [],
"bullishContents": []
},
"requestId": "xxx-xxx-xxx"
}